package com.stellar.circle.basic.service;

import com.stellar.circle.basic.entity.SComment;
import com.stellar.circle.controller.admin.sComment.vo.CommentStatistics;
import com.stellar.circle.controller.admin.sComment.vo.DailyCommentStatisticsVO;
import com.stellar.circle.controller.admin.sComment.vo.SCommentBaseVO;
import com.stellar.circle.controller.admin.sComment.vo.SCommentWithUserInfo;

import java.time.LocalDateTime;
import java.util.List;
import java.util.Set;

/**
 * 评论表(SComment)服务接口
 *
 * @author Jqchan
 * @since 2025-05-19 14:52:26
 */
public interface SCommentService {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    SComment queryById(Long id);

    /**
     * 条件查询单条结果
     *
     * @param condition 查询条件
     * @return 实例对象
     */
    SComment queryByCondition(SComment condition);

    /**
     * 条件查询全部结果
     *
     * @param condition 查询条件
     * @return 实例对象列表
     */
    List<SComment> queryAllByCondition(SComment condition);

    /**
     * 分页查询
     *
     * @param condition 查询条件
     * @param page      页码
     * @param pageSize  每页数量
     * @return 分页结果
     */
    List<SComment> page(SComment condition, int page, int pageSize);

    /**
     * 新增数据
     *
     * @param entity 实例对象
     * @return 影响行数
     */
    int insert(SComment entity);

    /**
     * 修改数据
     *
     * @param entity 实例对象
     * @return 影响行数
     */
    int update(SComment entity);

    /**
     * 通过主键删除
     *
     * @param id 主键ID
     * @return 影响行数
     */
    int deleteById(Long id);

    /**
     * 条件统计
     *
     * @param condition 统计条件
     * @return 总数
     */
    Long count(SComment condition);

    /**
     * 批量查询父评论的用户ID
     *
     * @param parentCommentIds
     * @return
     */
    List<SComment> batchQueryByParentIds(Set<Long> parentCommentIds);

    /**
     * 获取对比周期统计数据
     *
     * @param prevBeginTime 上一个周期的开始时间
     * @param prevEndTime   上一个周期的结束时间
     * @param sourceType    来源类型
     * @param isAnonymous   是否匿名
     * @param commentStatus 评论状态
     * @return
     */
    CommentStatistics getCommentStatistics(LocalDateTime prevBeginTime, LocalDateTime prevEndTime, String sourceType, Integer isAnonymous, String commentStatus);

    /**
     * 获取过去一周内每天的评论数
     *
     * @param startDate
     * @param endDate
     * @return
     */
    List<DailyCommentStatisticsVO> getDailyCommentCounts(LocalDateTime startDate, LocalDateTime endDate);

    /**
     * 更新评论回复数
     *
     * @param parentId
     * @param delta
     */
    void updateReplyCount(Long parentId, int delta);

    /**
     * 获取所有评论数据 - 包含用户信息
     *
     * @param sourceType
     * @param sourceId
     * @return
     */
    List<SCommentWithUserInfo> selectAllCommentsWithUserInfo(String sourceType, Long sourceId);

    /**
     * 获取一级评论 - 包含用户信息
     *
     * @param sourceType
     * @param sourceId
     * @return
     */
    List<SCommentWithUserInfo> selectRootComments(String sourceType, Long sourceId);
}
